PC Media 2

home *** CD-ROM | disk | FTP | other *** search

/ PC Media 2 / PC MEDIA CD02.iso / share / os2 / plycom10 / com_cfg.hlp (.txt) < prev next >

Wrap

OS/2 Help File | 1992-01-26 | 18.0 KB | 677 lines

ΓòÉΓòÉΓòÉ 1. Configuration program for POLY_COM ΓòÉΓòÉΓòÉ The Configuration program for POLY_COM is a Presentation Manager Application for the purpose of creation and changing configuration files for f╨ær POLY_COM. Help is available any time you press the F1 key from anywhere within the program. Because this is context sensitive help, the help information that is displayed depends on where in the program F1 was selected. For instance, you receive help for the Name entry field in the Port installation dialog Box when you click into that field and press <F1>. However, this is not the same help that is displayed when you press F1 after a click to the Background of the dialog box. Press Esc at any time to view the previous help window or to return to the application windows if there are no other help windows. Further Information according Help is available if you select Help for Help in the Help pull-down. ΓòÉΓòÉΓòÉ 2. File ΓòÉΓòÉΓòÉ The pull-down File contains functions to open and save the configuration files as well as for exiting the program. The highlighted selection in the pull-down window is selected by pressing the <ENTER> key. ΓòÉΓòÉΓòÉ 2.1. New ΓòÉΓòÉΓòÉ The selection of New in the pull-down window File creates a new configuration file. If you select New during editing a configuration, you will be asked whether you want to save or delete the currently edited configuration. ΓòÉΓòÉΓòÉ 2.2. Open ΓòÉΓòÉΓòÉ The selection of Open in the pull-down window File opens an already existing configuration file for POLY_COM. After selecting Open the dialog window "File open" pops up where the file to open is selected. If you select Open during editing a configuration, you will be asked whether you want to save or delete the currently edited configuration. ΓòÉΓòÉΓòÉ 2.3. Save ΓòÉΓòÉΓòÉ The selection of Save in the pull-down window File saves the currently edited configuration to a file on disk. Note: For saving a configuration, which has no name up to now, use the selection Save As. ΓòÉΓòÉΓòÉ 2.4. Save As ΓòÉΓòÉΓòÉ The selection of Save As in the pull-down window File performs the following tasks: o Save a file, having no name up to now. o Save an existing file - with an other name, - in an other directory or - on an other storage device. Note: After saving an existing file using another name, the new name will be the default filename for the Save action. After selecting Save As the dialog window "File Save" pops up where the drive, path and filename for the save action is selected. ΓòÉΓòÉΓòÉ 2.5. About ΓòÉΓòÉΓòÉ The selection of About in the pull-down window File shows the copyright information of the program. ΓòÉΓòÉΓòÉ 2.6. Exit ΓòÉΓòÉΓòÉ The selection of Exit in the pull-down window File or pressing the F3 Key will end the program POLY_COM. If changes are made in the configuration after the last Save you are asked whether you want to save or delete them before exiting. ΓòÉΓòÉΓòÉ 3. Port ΓòÉΓòÉΓòÉ The pull-down Port contains functions to create, delete or change port configurations for the device-driver program POLY_COM. The highlighted selection in the pull-down window is selected by pressing the <ENTER> key. ΓòÉΓòÉΓòÉ 3.1. Port installation ΓòÉΓòÉΓòÉ The selection of Installation in the pull-down window Port inserts a new port specification, containing enty fields for: o Device name o Base address und a check-box for o Single interrupt activation and o Buffer activation (when using a 16550AFN) This specification is added to those already the list-box afterwards. Note: POLY_COM reads only that number of specifications from the configuration file as storage fields are available in POLY_COM (typically 4). ΓòÉΓòÉΓòÉ 3.2. Port deinstallation ΓòÉΓòÉΓòÉ The selection of Deinstallation in the pull-down window Port deletes the port specification highlighted in the list-box without any further inquiry. ΓòÉΓòÉΓòÉ 3.3. Port change ΓòÉΓòÉΓòÉ The selection of Change in the pull-down window Port allows to make changes in the port specification highlighted in the list-box. ΓòÉΓòÉΓòÉ 3.4. Buffer parameters ΓòÉΓòÉΓòÉ The selection of Buffer Parameters in the pull-down window Port allows to make fine tunes in the extended hardware buffering of the port highlighted in the list-box. ΓòÉΓòÉΓòÉ 4. Help ΓòÉΓòÉΓòÉ The pull-down Help contains selections for various help textes for the configuration program for POLY_COM. The highlighted selection in the pull-down window is selected by pressing the <ENTER> key. ΓòÉΓòÉΓòÉ 4.1. Help for Help ΓòÉΓòÉΓòÉ The selection of Help for Help in the pull-down window Help shows a help text for the use of help in COM_CFG ΓòÉΓòÉΓòÉ 4.2. Extended Help ΓòÉΓòÉΓòÉ The selection of Extended Help in the pull-down window Help shows the extended help for the configuration program for POLY_COM. ΓòÉΓòÉΓòÉ 4.3. Help for Keys ΓòÉΓòÉΓòÉ The selection of Help for Keys in the pull-down window Help shows a help text itemizing the available keys and their functions. After the selection of this item a list of key groups is shown. A double-klick on one of the groups shows a description of the keys in this group and their functions. ΓòÉΓòÉΓòÉ 4.4. Help Index ΓòÉΓòÉΓòÉ The selection of Help Index in the pull-down window Help shows the help index for the configuration program for POLY_COM ΓòÉΓòÉΓòÉ 5. Main window of COM_CFG ΓòÉΓòÉΓòÉ This window is used to show a list of all devices supported by this driver and to change all values not related to a specific port: o List-box ports o Control address o Control value o Interrupt number To get a detailed help for an item in this list, double-click it. ΓòÉΓòÉΓòÉ 5.1. List-box "Ports" ΓòÉΓòÉΓòÉ Highlight the port you want to Deinstall or Change and select the corresponding entry in the pull-down Port afterwards. ΓòÉΓòÉΓòÉ 5.2. Control address ΓòÉΓòÉΓòÉ This Field is used only when operating "Multi-Port" cards. In case of normal or modified standard-type serial cards this field is not used. You enter "0" (or nothing at all). In case of "Multi-Port" cards the address of the control port is entered, which is used for common actions for all ports as e.g. interrupt activation. Enter the address in hexadecimal. The addresses for XENIX compatible 4-port cards are as follows: Card Address primary 02BF secondary 01BF ΓòÉΓòÉΓòÉ 5.3. Control value ΓòÉΓòÉΓòÉ This Field is used only when operating "Multi-Port" cards. In case of normal or modified standard-type serial cards this field is not used. You enter "0" (or nothing at all). In case of "Multi-Port" cards you enter the value has to be written to the control port to control common actions for all ports as e.g. interrupt activation. Enter the value in hexadecimal. The value is for XENIX compatible 4-port seriell cards: 80. ΓòÉΓòÉΓòÉ 5.4. Interrupt number ΓòÉΓòÉΓòÉ Enter the interrupt number the card uses here. It has to be the same number as the interrupt jumper on the card is switched to. The number may be entered in hexadecimal or decimal. This value is mandatory ! The available interrupts and their normal use are as follows: Interrupt Normal use INT 2 cascade-interrupt, is the interrupt jumper on the card sitting on "2", please enter "9" as interrupt number. INT 3 COM2 (also COM4) INT 4 COM1 (also COM3) INT 5 LPT2 oder network adapter INT 6 diskette drive INT 7 LPT1 (first printer, if any) INT 9 replacement for INT 2, lost because of cascading int controllers INT 10-12,14,15 usually free, but connected via the extended (16-bit-)connector. ΓòÉΓòÉΓòÉ 6. Dialog window "Port" ΓòÉΓòÉΓòÉ This dialog window is used for entry of a new port specification or for the change of an existing. A port specification consists of: o Device name o Base address und a check-box for o Single interrupt activation and o Buffer activation (when using a 16550AFN) For each field a specific help is available. For this purpose select the field with the mouse in this list. You can also set the focus to the specific control in the dialog window with the mouse or the <TAB> key and press the <F1> key when the field frame is highlighted. ΓòÉΓòÉΓòÉ 6.1. Port Name ΓòÉΓòÉΓòÉ Enter the device name, the device should wear afterwards, here. Note: Please use capital letters only for the device name. Serial ports usually wear the name COM1 for the first, COM2 for the second etc. ΓòÉΓòÉΓòÉ 6.2. Port Address ΓòÉΓòÉΓòÉ Enter the base address of the 16450 (16550AFN) here, which should be used for the device name entered above. Enter the address in hexadecimal. The usual addresses for standard-type serial cards are: Port Base Address COM1 03F8 COM2 02F8 COM3 03E8 COM4 02E8 For a primary XENIX-compatible 4-port serial card the following base addresses are used: Port Base Address Port 1 02A0 Port 2 02A8 Port 3 02B0 Port 4 02B8 The secondary card uses the addresses 1xx instead of 2xx. ΓòÉΓòÉΓòÉ 6.3. Checkbox single interrupt ΓòÉΓòÉΓòÉ When this box is checked (symbol in the box) the single interrupt activation is selected. This means that the interrupt output is routed directly to the bus by the "OUT2"-Pin of the serial chip. This is required when standard-type serial cards (single or double) are used. With "Multi-Port"-cards it will mostly lead to disturbing effects (usage of further interrupts). If you have interrupt-related problems (e.g. mouse, printer or COM-port non-functional), change this selection. ΓòÉΓòÉΓòÉ 6.4. Checkbox Buffer ΓòÉΓòÉΓòÉ When this box is checked (symbol in the box) the extended hardware buffering (FIFO) of a 16550 is activated. Note: If you check this box on a 16450 character losses in transmit direction may occur. The standard configuration of activated buffer is: Receive direction: When the receive buffer is filled with 50% (8 characters) an interrupt is generated. Transmit direction: The transmit buffer is always filled to the maximum 16 characters. Note: These parameters will be changeable in the next version. ΓòÉΓòÉΓòÉ 7. Dialog window "Buffer parameters" ΓòÉΓòÉΓòÉ This dialog window is used for the fine tunes in the extended hardware buffering. The following parameters could be changed: o transmitter buffer size o receiver buffer size o API-Transparency For each field a specific help is available. For this purpose select the field with the mouse in this list. You can also set the focus to the specific control in the dialog window with the mouse or the <TAB> key and press the <F1> key when the field frame is highlighted. ΓòÉΓòÉΓòÉ 7.1. Adjustment of Transmitter buffer size ΓòÉΓòÉΓòÉ The 16550 UART contains a queue (FIFO), which allows to put up to 16 characters in transmit direction into the chip in advance. So the UART will generate the next "Transmitter empty"-Interrupt not before all characters in the queue are transmitted. This will reduce the load resulting from interrupt servicing significantly. But there are some versions of the 16550 UART, wchich do not work properly when loded with 16 characters. If you are having troubles with your 16550 only after enabling buffers, first try to reduce the number of characters to transmit. Warning: This number of characters is sent in any way, even when protocol handling (e.g. RTS-CTS handshake) from the opposite device (e.g. modem) signals not to send characters because it is no more able to store characters. This will lead to a loss of characters when the receiving device does not send the "not ready" early enough ! ΓòÉΓòÉΓòÉ 7.2. Adjustment of Receiver interrupt trigger level ΓòÉΓòÉΓòÉ The 16550 UART contains a queue (FIFO) in receive direction also, which has space for 16 characters. The selection Receive gives the number of characters that have to be in the queue before an interrupt is generated. This will also reduce the load resulting from interrupt servicing. But there is a delay between interrupt generation and interrupt service, especially in high load situations. If the characters arriving in that time exceed the remaining space in the receive buffer (with a level of 14 only 2 are left), characters are lost. This effect depends very much on the selected baud rate. For example at an receiver interrupt trigger level of 14 the maxium delay between interrupt generation and servicing is 2 ms at 9600 bps, at 19200 1 ms and at 38400 only 0.5 ms are left and a baud rate of 57600 allows only a delay of 0.3 ms !!! At speeds exceeding 19200 the selection of 14 is rather unreliable and not necessary with the current available modems (maximum 14400 bps is about 1700cps during file transfers). Warning: When using software handshake (XON/XOFF) the received XOFF may be delayed by the buffer interrupt level. This leads to the result after adding to the transmission buffer size, that up to 30 characters could be sent in worst case after a received XOFF. If the other station is not prepared to receive that number of characters after XOFF, character losses will occur. ΓòÉΓòÉΓòÉ 7.3. Checkbox API-Transparency ΓòÉΓòÉΓòÉ The operating system/2 (OS/2) contains in its API (Application Program Interface) IOCTL (I/O-ConTroL) calls for the control of devices. This is, when looking to the serial ports, not only baud rate and similar parameters but the adjustment of the buffer parameters if the UART is a 16550. You could control the devices from the command line by the command MODE COMx:. This checkbox determines whether the buffer parameters could be controlled by an application (box checked) or whether the UART works with that values adjusted by the user in COM_CFG (box unchecked). In the latter case the UART will always use the buffer, independent whether the application tries to disable it or use it ineficciently. The application will be fooled that only a (nonbuffered) 16450 is available. When API-Transparency is switched on, there is a special meaning of the transmitter buffer size. If an application selects the transmitter buffer size of 16, only the selected number of characters in the Transmit group is sent to the UART. This allows to operate 16550s which do not work properly under API control otherwise. ΓòÉΓòÉΓòÉ 8. Dialog window for File selection ΓòÉΓòÉΓòÉ This dialog window is used for selecting files for load or save port configurations. The window contains controls for: An entry field for o file name and a list box for both o directories and o files For each field a specific help is available. For this purpose select the field with the mouse in this list. You can also set the focus to the specific control in the dialog window with the mouse or the <TAB> key and press the <F1> key when the field frame is highlighted. ΓòÉΓòÉΓòÉ 8.1. File name ΓòÉΓòÉΓòÉ If there isn't a name already selected, you can enter a filename in this field. If you want to open that file it must exist in the path shown by the Directory field. You may enter any Extension, but i recommend for clearness to use .CFG as Extension. It also possible to enter the complete path and drive name with the file name here. Examle: To open the file COM1.CFG in the directory OS2\SYSTEM on drive C, enter the following: C : \ OS2 \ SYSTEM \ COM1 . CFG ΓòÉΓòÉΓòÉ 8.2. Directories ΓòÉΓòÉΓòÉ The list-box Directories suits for selection of drive and directory, where the file to be edited is located. To select a drive or directory, do the following: Using the mouse o Double-Klick the drive or directory. or o Select the drive or directory o Push the OK. button Using the keyboard o Select the drive or directory using up and down arrow keys o Press the <ENTER> key ΓòÉΓòÉΓòÉ 8.3. Files ΓòÉΓòÉΓòÉ The list-box Files suits for selection of the file to be edited. To select a file, do the following: Using the mouse o Double-Klick the file name or o Select the file name o Push the OK. button Using the keyboard o Select the file using up and down arrow keys o Press the <ENTER> key ΓòÉΓòÉΓòÉ <hidden> File save ΓòÉΓòÉΓòÉ Because nothing has been changed since the last Save or Open action, saving of the configuration is currently not necessary. ΓòÉΓòÉΓòÉ <hidden> File new ΓòÉΓòÉΓòÉ The configuration has been changed since the last Save or Open action. If you want to save this changes, press the "YES" button, if not, press "NO" or press "CANCEL" to undo the selection of File New. ΓòÉΓòÉΓòÉ <hidden> File open ΓòÉΓòÉΓòÉ The configuration has been changed since the last Save or Open action. If you want to save this changes, press the "YES" button, if not, press "NO" or press "CANCEL" to undo the selection of File Open. ΓòÉΓòÉΓòÉ <hidden> File exit ΓòÉΓòÉΓòÉ The configuration has been changed since the last Save or Open action. If you want to save this changes, press the "YES" button, if not, press "NO" or press "CANCEL" to return to the program. ΓòÉΓòÉΓòÉ <hidden> No POLY_COM configuration file ΓòÉΓòÉΓòÉ The file opened by File Open was no configuration file for POLY_COM. The contents of the file can't be read by this program The file is left untouched. All configuration data in this program is reset. ΓòÉΓòÉΓòÉ 9. Help for Keys ΓòÉΓòÉΓòÉ Double-klick one of the following groups to get a help text for the keys in that group and the related funktions. o Keys for the action bar o Keys for menu o Keys for dialog windows o System keys ΓòÉΓòÉΓòÉ 9.1. Keys for the action bar ΓòÉΓòÉΓòÉ This keys select the system menu icon and the action bar entries. Key: Function: F10 Go to/from the action bar Shift+Esc Go to/from the system menu icon ΓöÇ Switch to the next action bar entry or to the system menu icon ΓöÇ Switch to the previous action bar entry or to the system menu icon Enter The highlighted action bar menu or the system menu is shown Mnemonic Symbol The mnemonic symbol is the underlined character in the action bar entry. If you press Alt+ the corresponding key the selected action bar menu is shown. Esc Switch back to the client window. ΓòÉΓòÉΓòÉ 9.2. Keys for menu ΓòÉΓòÉΓòÉ These keys activate selections in a menu window. Key: Function: The previous selection is highlighted The next selection is highlighted Enter The highlighted selection is called Mnemonic Symbol The mnemonic symbol is the underlined character in the menu. If you press the corresponding key the selected action is called. Esc The menu window is closed ΓòÉΓòÉΓòÉ 9.3. Keys for dialog windows ΓòÉΓòÉΓòÉ The following keys activate selections in dialog windows. Key: Function: Tab The next selection group within the dialog window is activated. Shift+Tab The previous selection group within the dialog window is activated. ΓöÇ The next button within the same selection group is activated. ΓöÇ The previous button within the same selection group is activated. The previous entry in a list-box is selected. The next entry in a list-box is selected. Page Go back a complete page in a list-box with the help of the scroll-bar at its side. Page Go forward a complete page in a list-box with the help of the scroll-bar at its side. Space key A check box is checked/unchecked. Enter The function of the selected push-button is executed. Esc The dialog window is destroyed. ΓòÉΓòÉΓòÉ 9.4. system keys ΓòÉΓòÉΓòÉ The following keys switch between presentation manager windows or change window position and size. Key: Function: Alt+Tab Switch to the next PM-Window. Alt+Shift+Tab Switch to the previous PM-Window. Alt+Esc Switch to the next Application (PM or Full-Screen) Strg+Esc Switch to the "Task List" window. Alt+F4 Close the currently active window. Alt+F5 Restore the currently active window. Alt+F7 Move the currently active window. Alt+F8 Change the size of the currently active window. Alt+F9 Change the currently active window to icon size. Alt+F10 Change the currently active window to screen size.